home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
bbs_soft
/
anufi20.zip
/
ANUFI.DOC
< prev
next >
Wrap
Text File
|
1993-05-23
|
24KB
|
781 lines
ANUFI 2.0
Anuncia nuevos ficheros
Manual de instrucciones
Programado por:
Juan Miguel Sosso Prieto, Marbella (Málaga)
Copyright (c) 1990, 1991 y 1992.
ANUFI 2.0 MANUAL DE INSTRUCCIONES
------------------------[ CONTENIDOS ]---------------------------
TEMA PAG
====================================================== ==
LICENCIA DE USO ...................................... 1
CONTENIDO DEL PAQUETE ................................ 2
¿QUE HACE EL PROGRAMA? ............................... 3
INSTALACION .......................................... 4
CONFIGURACION ........................................ 5
4Dos (+) ......................................... 5
Area ............................................. 5
Cabecera ......................................... 5
Directorios ...................................... 5
Empaqueta (+) .................................... 5
Encabeza (+) ..................................... 6
Excluye .......................................... 6
ExcluyeArea ...................................... 6
HazTotal ......................................... 6
Impresora (+) .................................... 6
Lista (+) ........................................ 6
Mail ............................................. 6
Motivo ........................................... 7
Nodo ............................................. 7
Origen ........................................... 7
Para ............................................. 7
Pie .............................................. 7
Procesa .......................................... 7
SysOp ............................................ 7
Rápido ........................................... 7
UTILIDAD AFF ......................................... 9
AGRADECIMIENTOS ...................................... 10
RemoteAccess es marca (c) de Continental Software
FroontDoor es marca (c) de Advanced Engineering Sarl
4DOS es marca (c) de JP Software Inc.
ANUFI 2.0 MANUAL DE INSTRUCCIONES
-----------------------[ LICENCIA DE USO ]-----------------------
Este programa no es de dominio público, es shareware,
representa muchas horas de trabajo por lo que si realmente lo vas
a usar, le vas a sacar utilidad, has de enviarme la cuota de
registro que asciende a 2.000 ptas, con lo cual estarás
registrado para todas las futuras versiones y serás avisado de
todo el software nuevo que realice. Para realizar tu registro
imprime el fichero REGISTRO.TXT que se adjunta.
Este programa puede ser copiado y puesto en BBSs siempre que
se haga en su estado original, y no puede ser vendido por nadie
sin expresa autorización mía. Lo único que puede ser cambiado es
el método de empaquetado de los ficheros del programa.
Cualquier problema que puedas tener con el programa ( daños
en ficheros, software, hardware o en tu reputación como sysop )
no es culpa mía, en mi ordenador vá bién, yo sólo te digo que el
programa ocupa sitio en el disco, y ni siquiera de eso estoy
seguro. NO GARANTIZO NADA.
El programa ha sido probado en varios ordenadores,
trabajando con RemoteAccess 1.10 y FrontDoor 2.02 y no ha dado
problemas ( mentira, lo que pasa es que se han solucionado, al
menos de momento ).
Esta licencia es válida para todos los programas incluidos
en este paquete, que son ANUFI y AFF.
Para registro, cualquier consulta o sugerencia:
Juan Miguel Sosso Prieto
c/ Málaga 40, 3º
29600 Marbella (España)
P.D.E. - RUN - (Mail Only)
Tel: +34-5-2825371
De 23:00h a 8:00h.
2:345/203@fidonet.org
9:953/77@magerit.esp
En el caso de recibir la cuota de registro y el formato
cumplimentado inmediatamente realizaré tu fichero llave que has
de incluir en el directorio del programa renombrándolo, si fuera
necesario, a ANUFI.KEY. Para obtener el fichero llave has de
llamar a mi sistema cuando recibas la notificación de la llegada
del dinero. Para más detalles imprimir el fichero REGISTRO.TXT.
- Pág 1 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
-------------------[ CONTENIDO DEL PAQUETE ]---------------------
El paquete, ANUFI20.ARJ ( si no se ha cambiado el método de
empaquetado ) incluye los siguientes ficheros:
ANUFI.EXE - El programa principal, versión 2.0
ANUFI.CFG - Fichero de configuración de ejemplo
ANUFI.DOC - Estas instrucciones que estás leyendo
MEJORAS.20 - Modificaciones realizadas desde la
versión anterior
CABECERA.TXT - Ejemplo de fichero de cabecera para el
mensaje
PIE.TXT - Ejemplo de fichero de pié para el
final del mensaje
LISTA.TXT - Ejemplo de cabecera de listado
AFF.EXE - El programa para actualizar la fecha
de los ficheros
REGISTRO.TXT - Formato de registro del programa
Si falta algún fichero consulta al sysop del B.B.S. donde
hayas obtenido el paquete, si él no sabe nada llama directamente
a mi sistema y con el magic ANUFI podrás conseguir la última
versión completa.
- Pág 2 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
-------------------[ ¿QUE HACE EL PROGRAMA? ]--------------------
El programa mirará todos los ficheros que estén en el disco
pertenecientes al BBS, o sea, contenidos dentro de las áreas de
ficheros del RemoteAccess, y creará un mensaje en un área de
echomail con una descripción de los ficheros que han entrado
nuevos al BBS desde la última vez que se ejecutó el programa.
Si no tenemos el software de BBS RemoteAccess podemos usar
ANUFI definiéndole las áreas a mano en el fichero de
configuración y pasándole una serie de datos que necesita al no
poder leerlos de la configuración de RemoteAccess.
En el mensaje que crea el programa se indica el nombre del
fichero nuevo, la longitud, área a la que pertenece y descripción
del mismo. Se creará un solo mensaje con todos los ficheros
nuevos, ocupando cada fichero dos líneas del mensaje más una en
blanco. También existe la posiblilidad de indicar al final del
mensaje el total de ficheros nuevos y la cantidad de bytes que
suman.
Para que el programa sepa que un fichero ha sido introducido
nuevo en las áreas es necesario que el fichero tenga la fecha de
creación igual a la actual, o sea, a la fecha y hora del momento
en que se mete nuevo, por lo tanto debe ser empaquetado de nuevo
o actualizada la fecha con la utilidad AFF (ver más abajo).
La idea del programa surgió por la necesidad de avisar a mis
puntos de los ficheros nuevos que entraban al BBS sin que
tuvieran que llamar en modo terminal. Ahora que mi BBS es un
sistema mail only he modificado ANUFI para que no dependa del
BBS, para tener unas áreas de ficheros y una lista de ficheros
perfectamente actualizadas diariamente.
- Pág 3 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
-------------------------[ INSTALACION ]-------------------------
Es muy simple, lo mejor es crear un directorio con el nombre
de ANUFI y extraer dentro de él todos los ficheros que componen
el programa. Una vez hecho esto debemos tener la variable de
entorno RA igual al path (directorio) donde se encuentren los
ficheros de RemoteAccess, si es que disponemos de este software.
Acto seguido debes editar el fichero de configuración
(ANUFI.CFG por defecto) e ir adaptándolo a tus necesidades,
configurando cada uno de los comandos que posee.
Junto con el programa se suministra una utilidad para
actualizar la fecha de los ficheros, ésta debe ser puesta en un
directorio de utilidades que esté incluido en el PATH del DOS. Ya
que el programa se guía por la fecha de los ficheros para saber
si son nuevos o no, podemos hacer que cualquier fichero sea
procesado de nuevo usando la utilidad AFF.
Debemos indicarle a RemoteAccess que cambie la fecha de los
ficheros que entren en el BBS si queremos que ANUFI anuncie el
área de Uploads o ficheros recién llegados.
- Pág 4 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
------------------------[ CONFIGURACION ]------------------------
La configuración del programa es muy sencilla, se halla en
un fichero de texto (ASCII) llamado ANUFI.CFG por defecto, en el
cual pueden ir los siguientes comandos:
* 4Dos (sin parámetros) (+)
Este comando indica a ANUFI que debe actualizar las
descripciones de los ficheros sobre las descripciones del
procesador de comandos 4DOS. Si usamos esta opción y tenemos 4DOS
al hacer un DIR en cualquier área de ficheros veremos las
descripciones de los mismos sin necesidad de editar el FILES.BBS.
* Area <número_de_área> [número_de_área] ...
Donde número_de_área es el área de mensajes en la cual
deseamos colocar el mensaje generado por el programa. Si no se
especifica número de área se tomará la uno por defecto. El área
debe ser de tipo ECHOMAIL. Se puede poner el mismo mensaje en
varias áreas distintas a la vez.
* Cabecera <[unidad:trayectoria\]fichero.ext>
Es un fichero de texto que será añadido al principio del
mensaje creado, y en el cual pueden ir datos sobre el horario del
BBS, horarios de request, velocidades permitidas, etc. El
programa añade una línea en blanco después de esta cabecera.
* Directorios <[unidad:trayectoria\]fichero.ext>
Si usamos, por ejemplo FrontDoor, con este comando se crea
un fichero de texto en el que irán, uno por línea, todos los
directorios contenidos en las áreas de RemoteAccess y los
definidos en las áreas manuales, después le indicamos a FrontDoor
este fichero como lista de directorios para request y se
actualizará automaticamente al dar de alta cualquier área.
* Empaqueta <comando> <parámetros> (+)
Aquí debemos especificar el comando que debe ejecutar ANUFI,
una vez realizada la lista de ficheros del BBS, para que esta sea
comprimida. Debemos indicar en los nombres de ficheros las
trayectorias completas, por ejemplo, si empaquetamos la lista con
LHA A MILISTA MILISTA.LST en el área de ficheros de textos
debemos indicarle a ANUFI:
Lista c:\fi\textos\milista.lst
Empaqueta lha a c:\fi\textos\milista c:\fi\textos\milista.lst
Con estas dos líneas ANUFI generará la lista de ficheros en
MILISTA.LST y la empaquetará en MILISTA.LZH en el área de
ficheros de texto.
- Pág 5 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
* Encabeza <[unidad:trayectoria\]fichero.ext>
Es un fichero de texto que será añadido al principio de la
lista de ficheros, y en el cual puede ir el logotipo del BBS,
horarios de request, velocidades permitidas, etc. El programa
añade una línea en blanco antes de empezar la lista.
* Excluye <especificación_de_fichero> [especificación...] ...
Donde <especificación_de_fichero> es el nombre de uno o
varios ficheros ( sin trayectoria ) que ha de ignorar el programa
aunque sean nuevos (como la lista de ficheros, nodelist o
similar). Este comando se puede repetir varias veces según el
número de ficheros que deseemos excluir de la comprobación y cada
línea puede contener varios nombres de ficheros separados por
espacios. Un nombre podría ser NODELIST.*
* ExcluyeArea <número_de_área> [número_de_área] ...
Donde número_de_área es el número del área de ficheros de
RemoteAccess que el programa debe ignorar. Se puede usar para
evitar que el programa compruebe el área de ficheros recién
llegados, para que el operador pueda comprobar estos ficheros
antes. El/las áreas excluidas aquí tampoco saldrán en el listado
de ficheros.
* HazTotal ( sin parámetros )
Si este comando aparece en el fichero de configuración le
indica a ANUFI que al final del mensaje debe incluir una línea
con el número total de ficheros nuevos y los bytes que suman en
total. Si solo existe un fichero nuevo el comando es ignorado.
* Impresora ( sin parámetros )
Con este comando indicamos a ANUFI que incluya códigos de
salto de página de impresora en el listado de áreas, por si
queremos imprimirlo.
* Lista <[unidad:trayectoria\]fichero.ext> (+)
Aquí especificamos el nombre del fichero en el cual deseamos
que se escriba la lista de ficheros del BBS. En la lista de
ficheros se incluirán al principio la cabecera y al final el pie
que especifiquemos en los comandos Cabecera y Pie. Dentro de la
misma se indicará el nombre, tamaño y descripción de los
ficheros, siendo la descripción truncada si no cupiera en la
línea.
* Mail <directorio_base_de_mensajes>
Comando para usar si no se dispone de RemoteAccess, en él se
especifica el directorio donde se encuentra la base de mensajes
echomail de FrontDoor o similar compatible QuickBBS.
- Pág 6 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
* Motivo <motivo_del_mensaje>
Es la línea que aparece en el "Re:" del mensaje, por defecto
es "Nuevos ficheros recibidos:" pero la puedes cambiar por otra
que creas más apropiada.
* Nodo <nodo@dominio>
Aquí podemos indicar la dirección usada en los mensajes
generados por ANUFI, este comando es obligatorio si no disponemos
de RemoteAccess.
* Origen <línea_de_origen>
Con este comando podemos especificar la línea de origen que
aparecerá en los mensajes generados por ANUFI, si no usamos
RemoteAccess es obligatorio especificar alguna, si no se usará la
de por defecto de RemoteAccess.
* Para <destino_del_mensaje>
Es la línea que aparecerá en el "To:" del mensaje. Por
defecto está a "Todos" pero se puede poner otra cosa como "*.*" o
un nombre en concreto.
* Pie <[unidad:trayectoria\]fichero.ext>
Es un fichero de texto que será añadido al final del mensaje
creado, y en el cual puede ir más información sobre el BBS que
anuncia los ficheros, aparte de la incluida en la cabecera. El
programa añade una línea en blanco entre el texto del mensaje y
el pie.
* Procesa <directorio> <nombre_del_área>
Comando para indicar las áreas de ficheros manuales, aparte
de las de RemoteAccess, que ANUFI debe procesar. Si no usamos
RemoteAccess debemos usar un comando Procesa por cada área de
ficheros del BBS, indicando el directorio de los ficheros del
área (donde se encuentra el fichero FILES.BBS) y el nombre de
dicha área.
* SysOp <nombre>
Aquí podemos indicar el nombre por el cual serán escritos
los mensajes de ANUFI, si no usamos RemoteAccess este comando es
obligatorio.
* Rápido ( sin parámetros )
Si este comando aparece en el fichero de configuración ANUFI
solo mirará por nuevos ficheros en las áreas que tengan su
FILES.BBS modificado desde la última vez que se ejecutó el
programa. Con esto se consigue una mayor rápidez analizando las
áreas, pero si se modifica la fecha de un fichero sin actualizar
la del FILES.BBS de su área este no será detectado como nuevo. La
utilización de este comando implica la no realización de la
- Pág 7 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
lista de ficheros y la no actualización de las descripciones de
4DOS (si estuvieran activas dichas opciones).
Un ejemplo de configuración de ANUFI lo puedes ver en el
fichero ANUFI.CFG que se adjunta, modifícalo para tus
necesidades.
Todos los comandos son insensibles a mayúsculas y
minúsculas, o sea, que pueden ser escritos en mayúsculas o en
minúsculas o mezclando las dos. Cualquier línea con un ; (punto y
coma) en la primera columna será considerada un comentario.
Por defecto ANUFI usará ANUFI.CFG como fichero de
configuración, pero podemos hacer que use cualquier otro
simplemente indicando su nombre en la línea de comandos al llamar
a ANUFI, ejemplo:
ANUFI MICONFIG.CTL
Gracias a esto podemos tener varias configuraciones
distintas para el mismo ANUFI para, por ejemplo, hacer que
ciertas áreas de ficheros se anuncien en ciertas áreas de
echomail simplemente corriendo ANUFI con distintos ficheros de
configuración.
Los comandos marcados con el signo (+) solo están
disponibles para los usuarios registrados.
- Pág 8 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
------------------------[ UTILIDAD AFF ]-------------------------
Dentro del mismo paquete se incluye una utilidad para
actualizar la fecha de los ficheros. Su manejo es muy simple,
teclearemos:
AFF FIVEPRO.ARJ
con esto conseguiremos que el fichero FIVEPRO.ARJ contenga
la fecha actual del sistema en vez de la de su creación, con lo
cual ANUFI entenderá que este fichero es nuevo.
También podemos usar comodines en el programa, por ejemplo,
para actualizar todos los ficheros que componen la última versión
de Telemate teclearemos:
AFF TM311-?.*
- Pág 9 -
ANUFI 2.0 MANUAL DE INSTRUCCIONES
-----------------------[ AGRADECIMIENTOS ]-----------------------
Quiero agradecer desde aquí la ayuda prestada al equipo de
beta-testers, que han estado haciéndole perrerías al programa
para ver si lo aguantaba:
- Fernando Martín, BBS La Radio (2:341/18@fidonet.org)
- Jose Manuel, BBS Tarsis (2:345/602@fidonet.org)
- Juan J. Achutegui, BBS * Polaris (2:344/7@fidonet.org)
- Pedro Navarro, BBS Kernel Sistemas (2:340/5@fidonet.org)
- Manuel Fuentes, BBS GALICIA-1 (2:348/5@fidonet.org)
Disculparme si me he olvidado de alguien, pero es que ha
sido mucha gente la que me ha estado ayudando en el proyecto.
Gracias también a Juan Ignacio, B.B.S. Alija
(2:345/401@fidonet.org), que ha colaborado con alguna que otra
rutina en la realización del programa, a Orlando Castillo, B.B.S.
No Man's Land (2:346/4@fidonet.org) por sus recomendaciones sobre
la línea ^aPID: y a mi hermana Eva Sosso por corregirme las
posibles faltas "burrográficas" del texto.
Y por supuesto, gracias a todas las personas que se han
registrado y han conseguido que haya merecido la pena realizar
este programa.
- Pág 10 -